home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / pascal / tvgas.exe / TVGAS.DOC < prev    next >
Text File  |  1990-10-17  |  13KB  |  314 lines
  1.                                         |
  2.                                         |
  3.                                         |
  4.                                         |
  5.                                         |
  6.                                         |
  7.                                         |
  8.                                         |
  9.                                         |
  10.                                         |
  11.   ██      ██                                                                |
  12.     █    █                                                                  |
  13.      █  █                                                                   |
  14.       ██                                                                    |
  15.      █  █                                                                   |
  16.     █    █                                                                  |
  17.   ██      ██                                                          Tvgas |
  18.                                                                 Version 2.1 |
  19.                                         |
  20.   ██  ██████                                                                |
  21.   ██  █   ██                                                    A Shareware |
  22.   ██  █   ██                               Turbo Pascal VGA Graphics Editor |
  23.   ██  █   ██                                                                |
  24.   ██  █   ██                                                                |
  25.   ██  █   ██                                                   User's Guide |
  26.   █████   ██                                                                |
  27.                                         |
  28.                                         |
  29.    ███ ████                                                                 |
  30.   █   █    █                                                                |
  31.   █   █    █                                                                |
  32.   █   █    █                                                                |
  33.   █   █    █                                                                |
  34.   █   █    █                                                                |
  35.   ██████████                                                                |
  36.                                         |
  37.   I n t e r n a t i o n a l                                                 |
  38.                                         |
  39.                                         |
  40.                                         |
  41.                                         |
  42.                                         |
  43.                                         |
  44.                                         |
  45.                                         |
  46.                                         |
  47.                                         |
  48.                                         |
  49.                                         |
  50.                                         |
  51.                                         |
  52.                                         |
  53.                                         |
  54.                                         |
  55.  
  56.  
  57.            BSX's No-License Nonsense Statement!
  58.  
  59.                  This product  (C) 1990 BSX International
  60.  
  61.    This software is provided "as is" with no guarantees of any kind. You,
  62. the user, are permitted and encouraged to distribute it and  use it,  but
  63. under the following conditions:
  64.  
  65.    1) You absolutely, positively may not sell  this  program  without the
  66. permission of BSX International.
  67.  
  68.    2) Under no  circumstances should you distribute versions of this pro-
  69. duct which  have  been altered in any way without the permission  of  BSX
  70. International.  You may add files, but MAY NOT remove any.
  71.  
  72.    3) Under no circumstances should you remove the copyright notices from
  73. the code or from the documentation which is provided with it.
  74.  
  75.    4) This is a shareware product.  You may  use  it for free for a short
  76. period.  After that you must either register or stop  using it.  You  may
  77. still distribute it, however.
  78.    If you find this  program  to be  a blast,  you ought to  send along a
  79. $5.00 registration fee PAYABLE TO ROBERT ROBERDS to:
  80.  
  81.                BSX International
  82.                806 Park Ridge Rd. Apt. A8
  83.                Durham, NC 27713
  84.  
  85. IMPORTANT:  Make checks payable to Robert Roberds.  Thanx!
  86.  
  87.    You may contact BSX International in writing or at (919) 493-4875. You
  88. also may reach us on Prodigy at JBVC54A.  Drop us a line!
  89.  
  90.         Pre-Documentation "Don't Panic" Reassurance
  91.  
  92.    Look, it's real easy.  These dox are nice, and you oughtta skim  them.
  93. But we gotta tell you:  It's a true gut to use TVGAS.
  94.  
  95.  
  96.                      TVGAS:  THE BSX SPRITE EDITOR
  97.  
  98. 0. Facts and Stats
  99.  
  100. This system contains the following files:
  101.    TVGAS.EXE  -The executable program.
  102.    TVGAS.DOC  -This document.
  103.    BSXCAT.DOC -BSX International catalog.
  104.    ORDER.DOC  -BSX International order form.
  105.  
  106. System requirements:
  107.    IBM PC,XT,AT,PS/2 or compatible.
  108.    256K RAM at the very least.
  109.    VGA or MCGA display hardware with full memory.
  110.    Microsoft Mouse or compatible.
  111.    DOS 2.1 or later.
  112.    Hard disk recommended because if you don't have one yer a real loser.
  113.  
  114. I. General Information
  115.  
  116.    TVGAS is a sprite editor for Turbo Pascal graphics programmers.It lets
  117. you  create  files containing the data for VGA/MCGA low-resolution images
  118. (320x200 pixels by 256 color mode).  These files can then be loaded  into
  119. memory and dumped to the screen via the PutImage function.  Sprites of up
  120. to 60x40 pixels can be created. Since MCGA is rapidly becoming a standard
  121. mode  for graphics games, we figure  there'll be demand  for this kind of
  122. utility.
  123.    "I'm sure," yer no doubt thinking, "that there  are plenty of programs
  124. like that around."  Well,  that's what _we_ thought. It  started  back in
  125. the summer of 1989 when BSX was working on the first of our truly sprite-
  126. intensive programs.  It dawned on us that we were going to have  to write
  127. our own kludgy sprite-producing program in order to  get through with it.
  128. Well, in the finest capitalistic tradition, we decided  to  write a nice,
  129. versatile,  user-lovable  sprite   editor  instead, to  fill this  gaping
  130. market  niche. This led to the EGA utility TEGAS, which begat the current
  131. VGA  product.  We hope you all find TVGAS useful.  We sure have.
  132.  
  133. II. Installation
  134.  
  135.    All you have to do is put tvgas.exe on yer disk and go.  If you put it
  136. in a directory that is in yer  DOS  search path, then  you can run  TVGAS
  137. from the DOS   command line,  regardless  of  the  directory  you  happen
  138. to be in.   TVGAS should load  with  no problem.   If  you  want TVGAS to
  139. run without sound, just use  the -s command-line switch, as in
  140.  
  141. tvgas -s
  142.  
  143.    Now yer all set.
  144.  
  145. III. Using TVGAS
  146.  
  147.    On startup, you'll be greeted by the annoying BSX hello  screen,  then
  148. sent to the work screen.  From here you may choose:
  149.  
  150.    EXIT: Kicks you back to DOS.
  151.  
  152.    LOAD: Loads a sprite file from disk.  You must only give the name, not
  153.          the extension.  TVGAS sprite files all end with .TPS.
  154.  
  155.    SAVE: Saves a sprite to disk.  Once again, just  give  the  file name;
  156.          don't give the extension.
  157.  
  158.    NEW:  Creates  a new sprite.  You pick the width and height of the new
  159.      sprite with the mouse in a self-explanatory way.
  160.  
  161.    DRAW: Picks the default drawing mode, wherein each click of the  mouse
  162.      sets one pixel.
  163.  
  164.    FILL: Does a region fill in the selected color.  Click inside the reg-
  165.      ion to fill it.
  166.  
  167.    LINE: Draws a line in the selected color. Click on the endpoints.
  168.  
  169.    CIRCLE: Draws a circle in the selected color.  Click first at the cen-
  170.     ter, then on the circumference.
  171.  
  172.    RECTANGLE: Draws a rectangle in the  selected  color.   Click  on  the
  173.     opposite corners.
  174.  
  175.    FLIP: Lets  you  either  FLIP  the  sprite (turn it upside down),   or
  176.     FLOP it (turn it left-to-right).  A secondary menu pops up to let
  177.     you choose which.
  178.  
  179.    A color: Pick a color just by clicking on its square at the top of the
  180.         screen.  Only 16 colors  are  displayed  at once,  but  you  have
  181.         access to all 256 by selecting...
  182.  
  183.    A palette: Above the big color selection squares are the smaller  pal-
  184.         ette selection squares.  Just click to select the palette you now
  185.         want to work with.  Note that the color of a  palette  square  is
  186.         the first color it corresponds to.  Any and all colors  from  any
  187.         and all palettes may be used in a given sprite, allowing for  256
  188.         colors in all.  Real pretty.
  189.  
  190.  
  191.    Using TVGAS images in yer programs:
  192.  
  193.    OK, here's the fun part.  Let's say yer writing a program in which you
  194. would like to put a 50x25 pixel image in different parts of  the  screen.
  195. Then you should start TVGAS, choose NEW, click to make  a  50x25  sprite,
  196. and edit away.  When yer done, you SAVE it as MYSPRITE.TPS and EXIT.
  197.    Now you write yer program. To use  VGA 320x200x256